home *** CD-ROM | disk | FTP | other *** search
/ GFX Sensations 1 / Graphic Sensations - Volume 1.iso / tools / amiga / 3d_tools / rend10.lzh / REND1.0 / REND1.0_README < prev    next >
Encoding:
Text File  |  1994-03-01  |  5.1 KB  |  110 lines
  1.  
  2. ------------------------------------------------------------------------------
  3.  
  4.                              REND 1.0
  5.                   
  6.                  February 7, 1994
  7.                 
  8.          A basic wireframe renderer for creating, visualizing and 
  9.              interacting with computer generated environments. 
  10.             
  11.           written by Michael P. Schenck mps4466@ultb.isc.rit.edu
  12.  
  13. ------------------------------------------------------------------------------
  14.  
  15.  
  16. SUMMARY -
  17.  
  18.     This software package was developed to provide the tools needed to 
  19. construct, visualize, and interact with a virtual environment.  The environment
  20. is generated from a series of primitives called models which are linked
  21. together and controlled through a hierarchial display map to create objects.
  22. There can be multiple objects and any number of nodes (action blocks) within
  23. a single object that link the primitives together.
  24.  
  25.     The view into the environment is controlled through a view structure
  26. which when reconfigured is used to display the next frame of graphics. The 
  27. view is a simple "camera" implimentation using spherical coordinates and
  28. parameters for far and near clipping planes.
  29.  
  30.     Other functions available in the library include a pause function and
  31. a getinput function.  The get input function will grab a character from the
  32. keyboard in a wait or nowait mode.
  33.  
  34.     The current implimentation of the renderer only supports drawing
  35. a wireframe output.  Clipping is done on a "whole" polygon basis which
  36. means that if any of a poly's verticies are outside the clipping limits 
  37. (view volume) then the entire poly is removed.  This can create annoying 
  38. visual artifacts if a poly is very large and near to the viewpoint.
  39.  
  40.  
  41. USING AND MAKING MODELS -
  42.  
  43.     The models used for the demos are in the ModelLibrary drawer which
  44. has a path set to it in the main program (see demo files)  The Model
  45. Utilities drawer contains two programs.  One converts an ascii model
  46. into the binary version needed by the renderer and the other takes
  47. parameters and generates a "plane" (mesh) model in binary format.  Just 
  48. execute them with no parameters to get details.  The two programs are compiled
  49. for the 020.  The input specifications for modeler are the number of
  50. verticies followed by the number of polys, then a list of all verticies
  51. followed by a list of all polys.  The polys indicate each vertex that
  52. makes them up followed by a zero.  Don't worry about closing the poly
  53. it is done automatically.  See the cube.asc and pyramid.asc files for
  54. examples of the format. (both of these create unit primitives)  The
  55. binary formats have a .bin extension
  56.  
  57.  
  58. COMPILING AND RUNNING DEMOS -
  59.  
  60.     To run this software you need a math coprocessor or it will crash!
  61. This is because it is based on a floating point environment.  To recompile,
  62. just modify the makefiles in the graphics subsystem and the main directory
  63. (for the demo files) and click build (you should do the graphicssubsystem
  64. first of course).  All you should need to change is the CPU type.  You will
  65. need a SAS/C 6.x compiler to rebuild it the way it is right now.  I havn't
  66. actually tried it on anything but 6.5x and 6.3, but it should work fine.
  67. I can't confirm that it will recompile correctly though.  If you are using
  68. version 6.5 of SAS/C, don't reassemble the blitter code (rasterasm.a) with
  69. the asm in that version.  For some mysterious reason it doesn't work!  The
  70. problems with asm were fixed in 6.51 so I would advise getting the patch.  
  71. If you don't have a compiler, compiled versions of the demos are provided
  72. for the 68020/6888x, and 68040/68882 processors.  Just double click
  73. on these to run!  Check out the module headers for more info on how to use
  74. them.
  75.  
  76.  
  77. USING THE GRAPHICS LIBRARY -
  78.  
  79.     For more details on how to use the library of routines, see the demo
  80. programs, the header files, and the modules.  Sorry the code is not more 
  81. descriptive and commented, but this library is just a small hack I wrote
  82. a while ago!  I am currently working on an extensive C++ VR Toolkit for the
  83. AMIGA (see the notice with this release).  I will of course be modifying this
  84. code to test ideas I may use in the Toolkit.  First of which is to impliment
  85. this pathetically slow renderer in fixed point integer arithmetic. If you
  86. find any bugs in this software or have questions about it, just send me
  87. email at the above address.  
  88.  
  89.                                 
  90. -------------------------------------------------------------------------------                     
  91.                LEGAL STUFF AND DISCLAIMER
  92. -------------------------------------------------------------------------------
  93.  
  94.      Copyright (C) 1993, 1994 -- by Michael P. Schenck, 
  95.      (mps4466@ultb.isc.rit.edu)
  96.      
  97.      This program is free software; you can redistribute it and/or modify
  98.      it under the terms of the GNU General Public License as published
  99.      by the Free Software Foundation; either version 2 of the License,
  100.      or (at your option) any later version.
  101.  
  102.      This software is distributed in the hope that it will be useful, but
  103.      WITHOUT ANY WARRANTY; without even the implied warranty of
  104.      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  105.      GNU General Public License for more details.
  106.  
  107.         For a copy of the GNU General Public License
  108.      write to the Free Software Foundation, 675 Mass Ave,
  109.      Cambridge, MA  02139, USA.
  110.